<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>PodPuppy User Guide</title>
    <link rel="stylesheet" type="text/css" href="stylesheet.css" />
</head>
<body>
    <div class="outer">
        <br />
        <br />
        <div class="inner">
            <div class="header">
                <img src="images/title.jpg" alt="PodPuppy - Free Podcast Reveiver" />
            </div>
            <div class="menubar">
            </div>
            <div class="content">
                <h1>
                    User Guide</h1>

                    <ol>
                        <li><a href="#Getting_Started">Getting Started</a>
                            <ol>
                                <li><a href="#Set_Your_Podcasts_Folder">Set Your Podcasts Folder</a></li>
                                <li><a href="#Subscribing_to_a_Podcast">Subscribing to a Podcast</a></li>
                                <li><a href="#Importing_Subscriptions">Importing Subscriptions</a></li>
                                <li><a href="#Searching_for_Podcasts">Searching for Podcasts</a></li>
                            </ol>
                        </li>
                        <li><a href="#The_Toolbar">The Toolbar</a>
                            <ol>
                                <li><a href="#The_Toolbar_Controls">The Toolbar Controls</a></li>
                                <li><a href="#Check_Podcasts_Button">Check Podcasts Button</a></li>
                                <li><a href="#Open_Podcasts_Folder_Button">Open Podcasts Folder Button</a></li>
                                <li><a href="#Resume_Downloads_Button">Resume Downloads Button</a></li>
                                <li><a href="#Pause_Downloads_Button">Pause Downloads Button</a></li>
                                <li><a href="#Unsubscribe_Fro_Selected_Podcasts_Button">Unsubscribe From Selected Podcasts Button</a></li>
                                <li><a href="#Raise_Podcast_Priority_Folder">Raise Podcast Priority Folder</a></li>
                                <li><a href="#Lower_Podcast_Priority_Folder">Lower Podcast Priority Folder</a></li>
                                <li><a href="#Search_or_Subscribe_Box">Search or Subscribe Box</a></li>
                            </ol>
                        </li>
                        <li><a href="#Options">Options</a>
                            <ol>
                                <li><a href="#Opening_the_Options_Dialog">Opening the Options Dialog</a></li>
                                <li><a href="#The_Downloads_Tab">The Downloads Tab</a>
                                    <ol>
                                        <li><a href="#Check_Feeds_Every_X_Minutes">Check Feeds Every X Minutes</a></li>
                                        <li><a href="#Maximu_Simultaneous_Downloads">Maximum Simultaneous Downloads</a></li>
                                        <li><a href="#Maximu_Total_Download_Speed">Maximum Total Download Speed</a></li>
                                        <li><a href="#Temporary_Download_Folder">Temporary Download Folder</a></li>
                                        <li><a href="#Podcasts_Folder">Podcasts Folder</a></li>
                                    </ol>
                                </li>  
                                <li><a href="#The_Balloons_Tab">The Balloons Tab</a>
                                    <ol>
                                        <li><a href="#Popup_a_Balloon_When_Download_Completes">Popup a Balloon When Download Completes</a></li>
                                        <li><a href="#Click_the_Balloon_To">Click the Balloon To</a></li>
                                    </ol>
                                </li>  
                                <li><a href="#The_Scheduler_Tab">The Scheduler Tab</a>
                                    <ol>
                                        <li><a href="#Enable_Scheduler">Enable Scheduler</a></li>
                                        <li><a href="#The_Scheduler">The Scheduler</a></li>
                                    </ol>
                                </li>  
                                <li><a href="#The_Syncroniser_Tab">The Syncroniser Tab</a>
                                    <ol>
                                        <li><a href="#Syncronised_Folder">Syncronised Folder</a></li>
                                        <li><a href="#Auto-Sync">Auto-Sync</a></li>
                                        <li><a href="#Synced_File_Types">Synced File Types</a></li>
                                    </ol>
                                </li>  
                                <li><a href="#The_Tagging_Tab">The Tagging Tab</a>
                                    <ol>
                                        <li><a href="#Set_Albu_to_Podcast_Title">Set Album to Podcast Title</a></li>
                                        <li><a href="#Set_Genre_to_Podcast">Set Genre to 'Podcast'</a></li>
                                    </ol>
                                </li> 
                                <li><a href="#The_Dynamic_OPML_Tab">The Dynamic OPML Tab</a>
                                    <ol>
                                        <li><a href="#Dynamic_OPML_Source">Dynamic OPML Source</a></li>
                                        <li><a href="#When_Subscribing_Just_Get_the_Latest_Item">When Subscribing Just Get the Latest Item</a></li>
                                        <li><a href="#When_Unsubscribing_Delete_Downloaded_Items">When Unsubscribing Delete Downloaded Items</a></li>
                                    </ol>
                                </li>   
                                <li><a href="#The_Misc_Tab">The Misc. Tab</a>
                                    <ol>
                                        <li><a href="#Launch_PodPuppy_When_Windows_Starts">Launch PodPuppy When Windows Starts</a></li>
                                        <li><a href="#Start_Minimized">Start Minimized</a></li>
                                        <li><a href="#Show_in_Taskbar_When_Minimized">Show in Taskbar When Minimized</a></li>
                                        <li><a href="#Include_File_Type_In_Search">Include File Type In Search</a></li>
                                        <li><a href="#Check_For_New_Version_At_Startup">Check For New Version At Startup</a></li>
                                    </ol>
                                </li>                                
                            </ol>
                        </li>  
                        <li><a href="./Tags.html">Tag Tokens</a></li>
                        <li><a href="#Reporting_Bugs">Reporting Bugs</a></li>    
                        <li><a href="#Getting_Help">Getting Help</a></li>                      
                    </ol>
                    
                    <ol class="sectionsList">
                        <li><h2><a class="anchor" id="Getting_Started">Getting Started</a></h2>
                            <ol class="sectionsList">
                                <li><h3><a class="anchor" id="Set_Your_Podcasts_Folder">Set Your Podcasts Folder</a></h3>
                                
                                    <p>Your <i>Podcasts Folder</i> is the folder that all your podcasts will be downloaded to.
                                    Within the podcasts folder one folder will be created for each podcast. By default your podcasts
                                    folder is your <i>My Music</i> folder. To change your Podcasts Folder..</p>
                                    
                                    <ol>
                                        <li>Click File->Options to open the Options Dialog.</li>
                                        <li>Select the Downloads Tab.</li>
                                        <li>Click the folder icon on the line labelled Podcasts Folder and browse to select you preferred folder.</li>
                                        <li>On the Options Dialog click OK to apply the change.</li>
                                    </ol>
                                
                                </li>
                                <li><h3><a class="anchor" id="Subscribing_to_a_Podcast">Subscribing to a Podcast</a></h3>
                                
                                    <p>
                                    PodPuppy is all about subscribing to Podcasts. There are two ways to do this..
                                    </p>
                                    
                                    <p>If you know the URL of the Podcast you want to subscribe to, just type or paste the URL
                                    into the <i>Search or Subscribe Box</i></p>
                                    <img src="images/screenshot1.png" alt="Typing a URL into the Search or Subscribe Box" />  
                                    
                                    <p>
                                    You can also subscribe to a podcast by dragging a link from your web browser. There are lots of websites
                                    that contain podcasts. Usually there will be a link labelled <i>subscribe</i>, <i>rss</i> or <i>atom</i>.
                                    Wherever you find a link like that you can drag it from the web browser to the podcasts list view in PodPuppy
                                    to subscribe.
                                    </p>         
                                    
                                     <img src="images/screenshot2.png" alt="Subscribing to a Podcast by Dragging a Link from Your Web Browser" />                             
                                </li>
                                <li><h3><a class="anchor" id="Importing_Subscriptions">Importing Subscriptions</a></h3>                                
                                    <p>
                                    PodPuppy can import a list of subscriptions from an OPML file. Select File->Import Subscriptions from the main menu
                                    and point to an OPML file.
                                    </p>                                                                                                               
                                </li>
                                <li><h3><a class="anchor" id="Searching_for_Podcasts">Searching for Podcasts</a></h3>
                                
                                    <p>
                                        To search Google for podcasts related to some keywords just type the keywords into the 
                                        <i>Search or Subscribe Box</i> and click the <i>Search or Subscribe Button</i>. This will bring up 
                                        your web browser with the results. You can drag the links directly from your web browser to
                                        PodPuppy to subscribe.                                        
                                    </p>
                                    <img src="images/screenshot3.png" alt="Using the Search or Subscribe Box to Search for Podcasts" />                             
                                </li>
                            </ol>
                        </li>
                        <li><h2><a class="anchor" id="The_Toolbar">The Toolbar</a></h2>
                            <ol class="sectionsList">
                                <li><h3><a class="anchor" id="The_Toolbar_Controls">The Toolbar Controls</a></h3>
                                <br />
                                <img src="images/toolbar.png" alt="The PodPuppy Toolbar" />
                                </li>
                                <li><h3><a class="anchor" id="Check_Podcasts_Button">Check Podcasts Button</a></h3>
                                <p>
                                PodPuppy will automatically check podcasts for new items on a regular basis, but if you don't want to wait for the 
                                next automatic check you can click the <i>Check Podcasts Button</i> to check podcasts for new items immediately.
                                </p>
                                </li>
                                <li><h3><a class="anchor" id="Open_Podcasts_Folder_Button">Open Podcasts Folder Button</a></h3>
                                <p>
                                Click the <i>Open Podcasts Folder Button</i> to open your podcasts folder in windows explorer so you can browse
                                and play your downloaded tracks.
                                </p>
                                </li>
                                <li><h3><a class="anchor" id="Resume_Downloads_Button">Resume Downloads Button</a></h3>
                                <p>When downloads are paused you can click the <i>Resume Downloads Button</i> to start downloading again.</p>
                                </li>
                                <li><h3><a class="anchor" id="Pause_Downloads_Button">Pause Downloads Button</a></h3>
                                <p>Click the <i>Pause Downloads Button</i> to temporarily stop all downloads. This feature is useful when you
                                want to free up bandwidth for a while. When you click the <i>Resume Downloads Button</i> the downloads will
                                resume where they left off.</p>
                                </li>
                                <li><h3><a class="anchor" id="Unsubscribe_Fro_Selected_Podcasts_Button">Unsubscribe From Selected Podcasts Button</a></h3>
                                <p>
                                When one or more podcasts are selected you can click the <i>Unsubscribe From Selected Podcasts Button</i> to remove them.
                                No more items will be downloaded for the selected podcasts. You will be asked whether you want to keep the items that have
                                already been downloaded.
                                </p>
                                </li>
                                <li><h3><a class="anchor" id="Raise_Podcast_Priority_Folder">Raise Podcast Priority Folder</a></h3>
                                <p>
                                When one podcast is selected you can click the <i>Raise Podcast Priority Folder</i> to increase its priority.
                                The higher priority podcasts will be downloaded first.
                                </p>
                                </li>
                                <li><h3><a class="anchor" id="Lower_Podcast_Priority_Folder">Lower Podcast Priority Folder</a></h3>
                                <p>When one podcast is selected you can click the <i>Raise Podcast Priority Folder</i> to decrease its priority.
                                The lower priority podcasts will be downloaded last.</p>
                                </li>
                                <li><h3><a class="anchor" id="Search_or_Subscribe_Box">Search or Subscribe Box</a></h3>
                                <p>
                                Enter a podcast url into the <i>Search or Subscribe Box</i> to subscribe to it.
                                </p>
                                <p>Anything you type into the  <i>Search or Subscribe Box</i> that doesn't start with <i>http://</i> will be 
                                interpreted as keywords for a search. PodPuppy will search google for podcasts related to the keywords. Your
                                web browser will be opened to display the results.</p>
                                </li>
                            </ol>
                        </li>
                        <li><h2><a class="anchor" id="Options">Options</a></h2>
                            <ol class="sectionsList">
                                <li><h3><a class="anchor" id="Opening_the_Options_Dialog">Opening the Options Dialog</a></h3>
                                <p>To open the options dialog click File->Options on the main menu.</p>
                                </li>
                                <li><h3><a class="anchor" id="The_Downloads_Tab">The Downloads Tab</a></h3>
                                    <ol class="sectionsList">
                                        <li><h4><a class="anchor" id="Check_Feeds_Every_X_Minutes">Check Feeds Every X Minutes</a></h4>
                                        <p>This setting controls how often PodPuppy will automatically check the subscribed podcasts for
                                        new items. Enter 0 to turn off automatic checking.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Maximu_Simultaneous_Downloads">Maximum Simultaneous Downloads</a></h4>
                                        <p>Enter a number between 1 and 20 to set the maximum number of simultaneous downloads.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Maximu_Total_Download_Speed">Maximum Total Download Speed</a></h4>
                                        <p>Use this setting to limit the amount of bandwidth that PodPuppy uses when downloading podcasts.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Temporary_Download_Folder">Temporary Download Folder</a></h4>
                                        <p>This setting controls the folder where partially downloaded tracks are stored. Once each
                                        track is fully downloaded it is copied to the Podcasts folder.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Podcasts_Folder">Podcasts Folder</a></h4>
                                        <p>The <i>Podcasts Folder</i> is the folder that all your podcasts will be downloaded to.
                                    Within the podcasts folder one folder will be created for each podcast. By default the podcasts
                                    folder is your <i>My Music</i> folder.</p></li>
                                    </ol>
                                </li>  
                                <li><h3><a class="anchor" id="The_Balloons_Tab">The Balloons Tab</a></h3>
                                    <ol class="sectionsList">
                                        <li><h4><a class="anchor" id="Popup_a_Balloon_When_Download_Completes">Popup a Balloon When Download Completes</a></h4>
                                        <p>Tick this box if you want PodPuppy to notify you each time a new track is downloaded with a popup balloon
                                        on the notification icon.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Click_the_Balloon_To">Click the Balloon To</a></h4>
                                        <p>When PodPuppy pops up a balloon to tell you that a track has been downloaded you can click on the
                                        balloon. The settings here allow you to choose what happens when you click on the balloon. Either
                                        your media player will be opened to play the track or windows explorer will be open the folder
                                        where the new track is located.</p>
                                        </li>
                                    </ol>
                                </li>  
                                <li><h3><a class="anchor" id="The_Scheduler_Tab">The Scheduler Tab</a></h3>
                                    <p>
                                    The scheduler allows you to program PodPuppy to pause and resume downloads at set times of the
                                    day or week. This is useful if you want PodPuppy to download at night or during working hours
                                    so that it doesn't use up bandwidth when you're using the computer.
                                    </p>
                                    <ol class="sectionsList">
                                        <li><h4><a class="anchor" id="Enable_Scheduler">Enable Scheduler</a></h4>
                                        <p>
                                        Tick this box to turn the scheduler on and enable the schedule editing control.
                                        </p>
                                        </li>
                                        <li><h4><a class="anchor" id="The_Scheduler">The Scheduler</a></h4>
                                        <p>
                                        Each cell in the grid represents an hour on a day of the week. Click in the cell to
                                        toggle whether PodPuppy will pause downloads during that hour.
                                        </p>
                                        </li>
                                    </ol>
                                </li>  
                                 <li><h3><a class="anchor" id="The_Syncroniser_Tab">The Syncroniser Tab</a></h3>
                                 <p>
                                 The Syncroniser helps you keep the podcasts on your portable media player up to date
                                 by allowing you to create a copy of your PodPuppy Podcasts folder on another drive
                                 with a single click, or even automatically.
                                 </p>
                                    <ol class="sectionsList">
                                        <li><h4><a class="anchor" id="Syncronised_Folder">Syncronised Folder</a></h4>
                                        <p>Set this to a folder on your portable media player or removable drive. This
                                        will be the portable copy of your Podcasts Folder.</p></li>
                                        <li><h4><a class="anchor" id="Auto-Sync">Auto-Sync</a></h4><p>
                                        You can syncronise at any time by selecting File->Syncronise from the main menu,
                                        but you can also have PodPuppy automatically syncronise each time the portable
                                        drive or media player is connected, just tick this box.
                                        </p></li>
                                        <li><h4><a class="anchor" id="Synced_File_Types">Synced File Types</a></h4><p>
                                        Use this setting to control the types of files that will be copied to your portable
                                        device by the syncroniser. This should be a space separated list of file extensions.
                                        It makes sense to include only the types of media that your device can play.
                                        </p></li>
                                    </ol>
                                </li>                                                                  
                                <li><h3><a class="anchor" id="The_Tagging_Tab">The Tagging Tab</a></h3>
                                 <p>
                                 PodPuppy can tag downloaded files with metadata, setting the album and or genre to make them
                                 easier to find on some media players. Note: this will only affect MP3 files.
                                 </p>
                                    <ol class="sectionsList">
                                        <li><h4><a class="anchor" id="Set_Albu_to_Podcast_Title">Set Album to Podcast Title</a></h4>
                                        <p>When ticked PodPuppy will set the album of all downloaded tracks to the title of the 
                                        podcast they are part of.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Set_Genre_to_Podcast">Set Genre to 'Podcast'</a></h4>
                                        <p>If this box is ticked PodPuppy will set the genre of all downloaded tracks to 'Podcast'.</p>
                                        </li>
                                    </ol>
                                </li>    
                                <li><h3><a class="anchor" id="The_Dynamic_OPML_Tab">The Dynamic OPML Tab</a></h3>
                                 <p>
                                 There are a number of online feed aggregation services (such as www.podnova.net) that
                                 allow you to build and maintain a personal list of podcast subscriptions. Your subscription
                                 list is then available online as an OPML file. PodPuppy can tie in with these services to allow you to
                                 remotely control your PodPuppy subscriptions.
                                 </p>
                                 <p>
                                 You can use the dynamic OPML options tab to point PodPuppy at your online subscriptions list and it
                                 will make and remove subscriptions as neccesary to stay up to date with the online version.
                                 </p>
                                 <p>
                                 You can have both dynamic and ordinary subscriptions at the same time.
                                 </p>
                                    <ol class="sectionsList">
                                        <li><h4><a class="anchor" id="Dynamic_OPML_Source">Dynamic OPML Source</a></h4>
                                        <p>Set this to the URL of an OPML file that represents your subscriptions list.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="When_Subscribing_Just_Get_the_Latest_Item">When Subscribing Just Get the Latest Item</a></h4>
                                        <p>If this box is ticked, when PodPuppy adds new subscriptions that it finds in the dynamic OPML it
                                        will only get the latest item, rather than all the items in the podcast.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="When_Unsubscribing_Delete_Downloaded_Items">When Unsubscribing Delete Downloaded Items</a></h4>
                                        <p>If this box is ticked, when PodPuppy removes dynamic subscriptions that are no longer in the dynamic OPML it
                                        will also delete any downloaded items belonging to them.</p>
                                        </li>
                                    </ol>
                                </li>     
                                <li><h3><a class="anchor" id="The_Misc_Tab">The Misc. Tab</a></h3>
                                    <ol class="sectionsList">
                                        <li><h4><a class="anchor" id="Launch_PodPuppy_When_Windows_Starts">Launch PodPuppy When Windows Starts</a></h4>
                                        <p>Tick this box to have PodPuppy start automatically each time you turn your computer on.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Start_Minimized">Start Minimized</a></h4>
                                        <p>If this box is ticked PodPuppy will always start minimized to the task bar.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Show_in_Taskbar_When_Minimized">Show in Taskbar When Minimized</a></h4>
                                        <p>By default PodPuppy does not show in the taskbar when minimized so as to save space, but you can change that behaviour by 
                                        ticking this box.</p>
                                        </li>
                                        <li><h4><a class="anchor" id="Include_File_Type_In_Search">Include File Type In Search</a></h4>
                                        <p>When you use the Search Box on the toolbar, podpuppy searches google for podcasts related to your keywords. With this box ticked
                                        the google query also specifies that the results must only include .xml and .rss files. The benefit of this
                                        is that you can usually drag links straight from the google results page to podpuppy to subscribe, however
                                        you may get fewer or less relevant results.</p></li> 
                                        <li><h4><a class="anchor" id="Check_For_New_Version_At_Startup">Check For New Version At Startup</a></h4>
                                        <p>If this box is ticked, PodPuppy will check to see if there is a newer version of the software
                                        each time it starts. If a newer version is found you will be asked whether you want to view the
                                        PodPuppy website downloads page.</p></li>                                    
                                    </ol>
                                </li>                                
                            </ol>
                        </li>
                        <li><h3><a class="anchor" id="Reporting_Bugs">Reporting Bugs</a></h3>
                        <p>If you find a bug in PodPuppy, please submit a bug report. To do this select Help->Report a Bug from the main menu.</p>
                        </li>   
                        <li><h3><a class="anchor" id="Getting_Help">Getting Help</a></h3>
                        <p>If you are having trouble with PodPuppy and can't find an answer here then you can always ask a 
                        question on the <a href="https://github.com/felixwatts/PodPuppy">Github project</a>.</p>
                        </li>                      
                    </ol>
                                                     
                <br />
                <br />
            </div>
        </div>
        <br />
        <br />
    </div>
</body>
</html>
